home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 026-050 / scopedisk28 / qmouse12 / qmouse.doc < prev    next >
Text File  |  1995-03-18  |  10KB  |  218 lines
  1.                            QMouse 1.2  by Lyman Epp
  2.  
  3.         Another "Mouse Accelerator???"  What for?  It seems that all the
  4.         other mouse accelerators have been written in "C".  This is okay,
  5.         but the programs are 10-30K.  This mouse accelerator is written
  6.         in assembler and contains most of the features of the others, but
  7.         the program size is less than 3K bytes!  Also, the source is
  8.         included so that you can add more features (please send me a copy
  9.         if you do.)  QMouse stands for "Quick Mouse."
  10.  
  11.         This is being distributed as ShareWare.  If you think that QMouse
  12.         is useful, please send $10.  Your response will insure the release
  13.         of more quality programs for your Amiga!  Programs already in the
  14.         works include: a disk based print spooler, a window dump that
  15.         converts the window bitmap back to text, and more.  Be sure to
  16.         check out the latest shareware version of QView.
  17.  
  18.         The latest version of QMouse can always be found on the Wind
  19.         Dragon Inn BBS, (402)-291-8053.
  20.  
  21.                 Lyman R. Epp
  22.                 10072 Wirt Plaza #15
  23.                 Omaha, Nebraska 68134
  24.  
  25.  
  26.  
  27. FEATURES:
  28.  
  29.         - Any option can be turned off or modified.
  30.  
  31.         - Screen blanks if keyboard or mouse is idle for a while.
  32.  
  33.         - The Mouse Pointer blanks if mouse is idle for a while.
  34.  
  35.         - Mouse Accelerator with configurable threshold to allow precise
  36.           mouse positioning.
  37.  
  38.         - Automatic window activation (i.e. Sun Mouse).  Makes the window
  39.           under the mouse pointer the active window.  Sun Mouse will not
  40.           activate windows while any mouse button is depressed.  This will
  41.           allow you to move WorkBench icons between windows.
  42.  
  43.         - Configurable command string ala PopCli, activated with the
  44.           Left_Amiga-ESC combination.
  45.  
  46.         - Left Mouse Button click in window brings it to the front
  47.           Does not bring the window to the front if it is already
  48.           in the front.  The number of clicks required is configurable.
  49.  
  50.         - Hold down the Left Mouse Button in a window and click the
  51.           Right Mouse Button to send that window to the back.
  52.  
  53.         - The smallest clock yet!  Can be turned off if you don't like
  54.           clocks.  Starting column is also configurable.  The clock
  55.           window will be brought to the front (of the WorkBench screen)
  56.           whenever it becomes obscured.
  57.  
  58.         - Uses a background CLI.  Programs like DMouse and PopCLI3 don't
  59.           use a background CLI, and therefore any NewCLI's spawned by
  60.           them will have no default directory, no default path, etc.
  61.           Using a background CLI simply requires that you use RunBack
  62.           (included) instead of Run (to allow closing the initial CLI.)
  63.           This should be viewed as very beneficial!  You can also set
  64.           stack size for any spawned CLI's.  This will allow you to set
  65.           a lower stack size before starting QMouse, but insure an
  66.           adequate stack size for spawned CLI's.
  67.  
  68.  
  69. EXECUTE FROM A CLI (e.g. WorkBench Startup-Sequence), example:
  70.  
  71.     1> Stack 4000
  72.     1> RunBack QMouse -c543 -v20000 "-eNewCLI con:0/0/640/150/AmigaDOS"
  73.     1> Stack 20000
  74.  
  75.  
  76. TO KILL:
  77.  
  78.     Press Ctrl-Left_Amiga-ESC (all at the same time.)
  79.  
  80.  
  81. SOURCE:
  82.  
  83.     Source may be assembled with the Metacomco assembler or with the
  84.     Manx assembler.  The Manx assembler creates about 5-10% smaller code!
  85.     See the included makefile for assembling with Manx.  This probably
  86.     won't assemble with versions of Manx before 3.6a.
  87.  
  88.  
  89. COMMAND LINE ARGUMENTS:
  90.  
  91.     Arguments can be typed in upper or lower case.  Arguments can be enclosed
  92.     in quotes, e.g. "-a3" or "-eNewCLI con:0/0/640/200"  Quotes are required
  93.     if the argument contains spaces, otherwise they are optional.
  94.  
  95.     -a#         Set acceleration to #.  Can be in the range of 0 to 65,535.
  96.                 Mouse movement events that have X or Y motion greater
  97.                 than the Acceleration threshold (see option -t) will be
  98.                 accelerated by this factor.  The default is 3.  To disable
  99.                 this feature, specify 0 or 1.
  100.  
  101.     -b          Enable click to back feature.  Hold down the Left Mouse
  102.                 Button in a window and click the Right Mouse Button to send
  103.                 that window to the back.
  104.  
  105.     -c#         Activate clock.  You can also specify an optional column
  106.                 where the clock will be displayed.  The column number must
  107.                 be in the range of 0 to (Screen Width - 44).  The width of
  108.                 the clock is 44 pixels.  To place the clock next to the
  109.                 front/back gadgets, use a value of (Screen Width - 44 - 53).
  110.                 With a screen width of 640, this would be a column value of
  111.                 543 (-c543).  The default column is 280.
  112.  
  113.     -eCOMMAND   Set Command to run.  If the command contains spaces, then
  114.                 the entire command must be enclosed in quotes.  This feature
  115.                 can be placed anywhere on the command line.  The default
  116.                 command is "NewCLI".
  117.  
  118.     -k#         Set number of clicks required to bring a window to front.
  119.                 Will not call WindowToFront() if the window is already the
  120.                 front window.  The default is 2 clicks.  To disable this
  121.                 feature, specify 0 clicks.  Can be in the range of 0 to
  122.                 65,535 clicks.
  123.  
  124.     -m          Deactivate Left_Amiga-M to send front screen to back.
  125.  
  126.     -p#         Set the number of seconds to wait after a mouse event before
  127.                 making the mouse pointer invisible.  Gets the mouse pointer
  128.                 out of your way!  Just move the mouse again and the pointer
  129.                 will reappear.  The default is 10 seconds.  To disable this
  130.                 feature, specify 0 seconds.  Can be in the range of 0 to
  131.                 65,535 seconds.
  132.  
  133.     -r          Enable automatic window activation (i.e. Sun Mouse).  When-
  134.                 ever the pointer is moved into a window, that window will
  135.                 be made active.  Sun Mouse will not activate windows while
  136.                 any mouse button is depressed.  This will allow you to move
  137.                 WorkBench icons between windows.
  138.  
  139.     -s#         Set the number of seconds to wait after any event (keyboard,
  140.                 mouse or disk changed) before blanking the screen.  Keeps
  141.                 an image from "burning in" to your monitor.  Just move the
  142.                 mouse, type a key or insert a disk and the screen will be
  143.                 restored.  The default is 600 seconds.  To disable this
  144.                 feature, specify 0 seconds.  Can be in the range of 0 to
  145.                 65,535 seconds.
  146.  
  147.     -t#         Set mouse acceleration threshold in pixels per event.  Any
  148.                 mouse movement events that have X or Y motion greater than
  149.                 this number will be accelerated by the acceleration factor
  150.                 (see option -a).  This option provides a way to position
  151.                 the mouse pointer precisely, without the acceleration
  152.                 factor "getting in the way."  The default is 3.  Can be in
  153.                 the range of 0 to 65,535 pixels per event.
  154.  
  155.     -v#         Set the stack size for any spawned CLI's.  This allows the
  156.                 stack size for the QMouse's CLI to be set to a minimum.
  157.                 Can be in the range of 1800 to 655,360 bytes (should be
  158.                 more than adequate!)
  159.  
  160.  
  161. CREDITS
  162.  
  163.     This program has been inspired by PopCLI, Mach, DMouse, MouseOff and
  164.     others.  Thanks to the authors of these programs for providing good
  165.     examples of how to make the Amiga "do its thing!"
  166.  
  167.  
  168.  
  169.  
  170.                             RELEASE 1.1 NOTES
  171.                                08-Jul-1988
  172.  
  173.  
  174.     - Made the clock come to the front whenever its been obscured, rather
  175.       than every 10 seconds.  This was bothering some programs.
  176.  
  177.     - The manual incorrectly documented the Ctrl-Left_Amiga-ESC method of
  178.       terminating QMouse.  This should have read Ctrl-Left_Amiga-F1, but
  179.       I changed the program to work as documented.
  180.  
  181.     - Intuition will restore the mouse pointer occasionally.  I changed
  182.       QMouse to re-blank the mouse pointer quicker than before.
  183.  
  184.  
  185.  
  186.                             RELEASE 1.2 NOTES
  187.                                30-Aug-1988
  188.  
  189.  
  190.     - Modified to assemble with the Manx assembler.  The Manx assembler
  191.       creates about 5-10% smaller code.  See the included makefile for
  192.       assembling with the Manx assembler.  Source will still assemble
  193.       with the Metacomco assembler as before!
  194.  
  195.     - Intuition calls are now made from the QMouse task, rather than
  196.       from the input handler.  This should resolve any Intuition lockups.
  197.  
  198.     - WindowToFront() not called for BACKDROP type windows.  This should
  199.       help eliminate the possibility of WorkBench locking up.
  200.  
  201.     - Added automatic window activation (i.e. Sun Mouse).  Specify option
  202.       -r to activate Sun Mouse (-s was already used.)
  203.  
  204.     - Added click to back feature.  Specify option -b to activate click
  205.       to back.
  206.  
  207.     - Added stack size feature.  Allows QMouse to run with a smaller
  208.       stack while insuring adequate stack size for spawned CLI's.
  209.       Specify option -v to change the default stack size.
  210.  
  211.     - Fixed bug with clicking to front a window on a screen that is in
  212.       the background.  No one had reported this bug yet.  ;-)
  213.  
  214.     - Cleaned up documentation and fixed any inaccuracies that I found.
  215.       Documentation for option -m now reads to "deactivate" the screen
  216.       shuffler.  Actually, the -m option was ignored until release 1.2.
  217.  
  218.